Inside Macintosh: QuickTime /

Chapter 2 - Movie Toolbox / Movie Toolbox Reference

Functions for Getting and Playing Movies / Error Functions

SetMoviesErrorProc

The Movie Toolbox allows applications to perform custom error notification. Your application must identify its custom error-notification function to the Movie Toolbox. The SetMoviesErrorProc function allows you to identify your application's error-notification function. Error-notification functions can be especially useful when you are debugging your program.

pascal void SetMoviesErrorProc (ErrorProcPtr errProc, 
                                 long refcon);

errProcPtr

Points to your error-notification function, MyErrProc.

The entry point to your error-notification function must take the following form:

            pascal void MyErrProc (OSErr theErr, long refCon);

See "Application-Defined Functions" beginning on page 2-332 for details on the parameters.

refcon

Contains a reference constant value. The Movie Toolbox passes this reference constant to your error-notification function each time it calls your function.

DESCRIPTION

Once you have identified an error-notification function, the Movie Toolbox calls your function each time the current error value is to be set to a nonzero value. The Movie Toolbox manages the sticky error value. The Movie Toolbox calls your error-notification function only in response to errors generated by the Movie Toolbox.

SPECIAL CONSIDERATIONS

The SetMoviesErrorProc function is just for debugging.

ERROR CODES

None